BBS Toolkit

home *** CD-ROM | disk | FTP | other *** search

/ BBS Toolkit / BBS Toolkit.iso / doors_2 / voter126.zip / VOTER.DOC < prev next >

Wrap

Text File | 1992-08-15 | 46KB | 1,024 lines

██┐ ██┐ ███████┐ ████████┐ ███████┐ ███████┐ ██│ ██│ ██┌──██│ └──██┌──┘ ██┌────┘ ██┌──██│ ██┐ ██┌┘ ██│ ██│ ██│ █████┐ ███████│ ██┐██┌┘ ██│ ██│ ██│ ██┌──┘ █┌─██┌┘ ███┌┘ ███████│ ██│ ███████┐ ██│ ███┐ └──┘ └──────┘ └─┘ └──────┘ └─┘ └──┘ ███████┐ ██┐ ██┐ ██┐ ███████┐ ██┐ ██┌──██│ ██│ ██│ ██│ ██┌────┘ ██│ ███████│ ██│ ██│ ██│ ███████┐ ██████████┐ ██┌────┘ ██│ ██│ ██│ └────██│ └──██┌───┘ ██│ ██████┐ ███████│ ███████│ ██│ └─┘ └─────┘ └──────┘ └──────┘ └─┘ Premier Voting Door For Electronic Bulletin Board Systems Written by: Keith N. Cochran - Paradox BBS (302) 645-7264 Voter Plus Copyright 1992 Keith N. Cochran - All Rights Reserved. Release Version: 1.26 2 ------------------------------------------------------------------------- Voter Plus ------------------------------------------------------------------------- TABLE OF CONTENTS Page ----------------- ---- INTRODUCTION ------------ 1.0 What Is Voter Plus 3 1.1 Features 3 1.2 Multi-Nodes, Networks, Multi-taskers 4 INSTALLING VOTER PLUS --------------------- 2.0 Preliminaries 4 2.1 Configuring PCBoard Door Files 4 2.2 Setting Up Door Batch Files 5-6 2.3 Configuring VOTER.CNF 6 2.4 Configuring VOTER.DAT 6 2.5 The Control Files Associated With Each Booth 7-8 2.6 Other Files Associated With Voter Plus 8 USING VOTER PLUS ---------------- 3.0 Entering The Door 8 3.1a Voting On A Booth 9-10 3.1b Leaving A Comment 10 3.2 Viewing The Booth Results 10 3.3 Creating New Booths 11 3.4a Turning Color On & Off 11 3.4b Turning Expert Mode On & Off 11 3.5 Redisplaying The Initital Screen 11 3.6 Returning To The BBS 12 3.7a Editing A Booth 12 3.7b Deleting A Booth 12 3.8 SysOp Report 12 3.9 Getting Help In Voter Plus 13 MISCELLANEOUS ------------- 4.0 Technical Notes 13 4.1 Running Voter Plus In Stand-Alone Mode 13 4.2 Where To Receive Assistance 14 4.3 Error Messages 14 4.4 Caller Log Entries 14 4.5 Problems With Non-PCBoard Systems 15 4.6 PCBoard Color Codes 16 4.7 Disclaimer and Warranty 16 4.8 Kudos 17 REGISTRATION ------------ 5.0 Registering Voter Plus 17 3 ------------------------------------------------------------------------- Page 3 Voter Plus Page 3 ------------------------------------------------------------------------- 1.0 What is Voter Plus ----------------------- Voter Plus is a full-featured public opinion voting door. It is primarily designed to be run on PCBoard based systems, but should run fine on any system type that can create PCBOARD.SYS, PCBOARD.DAT and a USERS file, either directly, thru the use of a door monitor type program, or thru the use of a convertor program. It has currently been tested on PCBoard 14.5a, ProLogon/ProDoor, and Spitfire 3.2 systems. I will detail a few of the problems encountered with non-PCBoard systems a little later in this documentation. Callers seem to love this door both on my own system and on the BBS's that have been ßeta testing it. It allows them to express their feelings regarding important subjects facing the world as well as those that are not so important. They enjoy watching the votes add up and really like the colorful graph display of the results. So give Voter Plus a try. Chances are it will quickly become one of the most frequently used doors on your system. 1.1 Features ------------- * Ability to handle up to 99 voting booths. * Up to 25 answers per voting booth. * Single configuration file required. * Multi-Node support with full file locking and sharing. * Written using Sam Smith's ProKit libraries for proven reliability * Full monitoring of carrier. * Support for extended COM ports & IRQ's. * Optional writing of pertinent information to the CALLERx log. * Local test mode. * Optional changing of original vote in each booth. * Optional adding of the caller's own answer. * Colorful ANSI graph results. * Complete Booth Editing, Creating, and Deleting functions. built-in (limited to SysOp in the unregistered version). * All data files are plain ASCII text files for easy editing. * The creator of a new booth may write a detailed description of the booth subject. * The caller may leave a 5 line comment after voting on the booth. * Choice of Colorful ANSI Graph or Chart style displays of voting results. * And much more... 4 ------------------------------------------------------------------------- Page 4 Voter Plus Page 4 ------------------------------------------------------------------------- 1.2 Multi-nodes, networks, multi-taskers ----------------------------------------- Voter Plus was developed on a 80386 running 2 nodes of PCBoard 14.5a in the background. It has been thoroughly tested here and on two other systems running multi-node. It has not been tested under a LAN environment, but there should be no problems whatsoever running it on a LAN, as the ProKit libraries HAVE been run in many LAN environments for many years without problems. Voter Plus is DESQview aware. It is automatically detected, screen and keyboard I/O are "well behaved", and time slices are given back to other applications while Voter Plus is idle. 2.0 Preliminaries ------------------ Create a directory or subdirectory where you normally place doors. Extract the entire contents of VOTER100.ZIP into this location. All files enclosed in VOTER100.ZIP must be located in the same location with VOTER.EXE in order for the program to function properly. NOTE! The one exception to the above is the file NWBTHxxx.ZIP and it's contents. This is a companion program to Voter Plus and will be discussed later in this documentaion. 2.1 Configuring PCBoard Door Files ----------------------------------- Voter Plus is not intended to be run as a PCBoard "SHELL" door, and while it may run successfully in SHELL mode on some systems, it is recommended that it be run as a normal door. Install a door called VOTE or whatever you decide to call it into your DOORS.LST file using PCBSETUP. Answer the following questions: USER DOOR Filename Password Sec Login SYS SYS Shell Path to DOOR Files -------- -------- --- ----- --- --- ----- ------------------ #) VOTE 30 N N N N (if appropriate) A password would usually NOT be required for your VOTE door. A USERS.SYS file is NOT needed and should not be created. A DOOR.SYS file is NOT needed and should not be created. If you are using BBS software other than PCBoard, check the appropriate documentation for instructions on setting up doors. Also see SECTION (4.5) for additional information. 5 ------------------------------------------------------------------------- Page 5 Voter Plus Page 5 ------------------------------------------------------------------------- 2.2 Setting up door batch files -------------------------------- The purpose of this section is to explain the command line calling syntax for Voter Plus. Please refer to the manual that accompanied your BBS software for a more complete discussion on door batch file installation. If you have named the door VOTE the following examples would be the contents of your door file named VOTE (NOTE: do NOT place an extension such as .BAT on the VOTE file). Contents of sample VOTE file: ----------------------------- @echo off d: cd \pcbdoors\vote VOTER.EXE VOTER.CNF C:\PCB <-| This is the node's home directory. c: cd \pcb <-| Return to system directory. board.bat <-| Reload the BBS 2.3 Configuring VOTER.CNF -------------------------- Enclosed with Voter Plus is a file called VOTER.CNF This is the main configuration file for Voter Plus. Only one VOTER.CNF file is required for all nodes. Each parameter in VOTER.CNF is described on the following pages. Line 1 : INTERRUPT or BIOS; Use BIOS only if INTERRUPT fails to work. Line 2 : Number of booths that exist. (This is maintained automatically). Line 3 : SysOp Name. Line 4 : Are you running PCBoard 14.5 or greater ? YES/NO * Line 5 : Allow caller to DELETE a booth he has created? YES/NO * Line 6 : Allow caller to EDIT a booth he has created? YES/NO Line 7 : Write entries to CALLERx log? YES/NO Line 8 : Display Verbose Msgs On File Updates? YES/NO Line 9 : Minimum security to CREATE A BOOTH Line 10: Minimum security to VOTE On A BOOTH Line 11: Force caller to vote first? YES/NO * Line 12: Comment line #1 to be written to NEWBOOTH.DSP * Line 13: Comment line #2 to be written to NEWBOOTH.DSP Detailed explanation: Line 1 - INTERRUPT is the fastest and the preferred choice. If you experience lock ups or other problems, try BIOS Line 2 - This is where Voter Plus keeps track of how many booths are currently defined. This entry is maintained automatically by Voter Plus when a new booth is created or when an old booth is deleted. 6 ------------------------------------------------------------------------- Page 6 Voter Plus Page 6 ------------------------------------------------------------------------- Line 3 - This should be the name you use when you log on to the BBS. It is used to let Voter Plus recognize that you are the SysOp so that global delete and edit functions can be used. The SysOp may edit or delete ANY booth, regardless of who created it or whether the door is registered or not. Line 4 - If you are running PCBoard 14.5 or greater then enter a YES in this line. Otherwise enter a NO. Line 5 - If set to YES, the caller will be permitted to DELETE any booth that he created. *This is available only in the registered version of Voter Plus. Line 6 - If set to YES, the caller will be permitted to EDIT any booth that he created. *This is available only in the registered version of Voter Plus. Line 7 - If set to YES, an entry will be written to the CALLERx file when a caller CREATES A BOOTH, DELETES A BOOTH, VOTES ON A BOOTH or ADDS AN ANSWER to a booth. Line 8 - Display verbose messages to the caller? If YES, full info will be displayed to the caller. If NO, info displayed will be minimal. Line 9 - This line should contain a numeric value equal to the minimum security level needed to Create a New Booth. Valid values range from 0 to 65536. Line 10 - This line should contain a numeric value equal to the minimum security level needed to Vote On a Booth. Valid values range from 0 to 65536. Line 11 - If set to YES, the caller will not be allowed to view the results of a booth, unless they have voted on it first. Line 12 - *When registered, Voter Plus writes a file called NEWBOOTH.DSP when a new booth is created. The contents of lines 12 & 13 will be added to this file. Using the companion program, NEWBOOTH.EXE this file may be displayed to the caller when the log. This is explained in greater detail in the documentation contained in NWBTHxxx.ZIP. Line 13 - See description for Line 12. NOTE: Under normal circumstances, once VOTER.CNF is setup, it should requires no further maintenance by the SysOp. 2.4 Configuring VOTER.DAT -------------------------- VOTER.DAT is where Voter Plus stores the names of the individual booths. Each booth entry occupies two sequential lines in this file. The first of the two is the DOS filename that the door uses to associate the different control files with that booth. The second line is the name of the booth. This file, like all of Voter Plus's files, is maintained by the 7 ------------------------------------------------------------------------- Page 7 Voter Plus Page 7 ------------------------------------------------------------------------- door and should never require manual editing. 2.5 The individual control files associated with each booth. ------------------------------------------------------------- The following files are created, updated, and deleted automatically by Voter Plus. I am supplying a brief explanation only so that in the unlikely event that they should become damaged, that you can edit them manually. The are all normal ASCII text files. Included in VOTERxxx.ZIP is a sample of each file with the name of THISBBS.xxx, where xxx is the extension. THISBBS.VTR - This file contains the following information: This BBS <==== Name of this booth SysOp <==== Who created this booth. ( See note below ) 02-25-92 <==== Date it was created YES <==== Allow user to add their own answer NO <==== Allow uses to change their vote 14 <==== Total votes In what areas should this BBS improve ? <=== The question 10 <=== Number of answers File Areas -- more files <=== Answer #1 3 <=== Votes for answer #1 File Areas -- more categories <=== Answer #2 0 <=== Votes for answer #2 File Areas -- more diversity <=== Answer #3 0 <=== Votes for answer #3 etc.... Until end of answers.... Note: If the creator's name is prefixed by a * then it will be suppressed. See the section on command's for details. THISBBS.USR - This file contains the names of those users that have voted on THIS booth. Simply their name followed by the number of the answer they chose. This is to prevent anyone from voting twice on the same booth, and if the CHANGE VOTE option is set to YES, it is used to adjust the vote count for the affected answers. John Smith 1 Jane Doe 3 Mary Jones 4 etc.... Until end of file. 8 ------------------------------------------------------------------------- Page 8 Voter Plus Page 8 ------------------------------------------------------------------------- THISBBS.TXT - This file contains the extended description of the booth. This file is optional and will only exist if the person that created the booth chose to enter an extended description. If it does exist, it will be displayed prior to voting, and prior to viewing the results of the booth it is associated with. THISBBS.CMT - This file contains the 5 line comments that each voter is permitted to enter after they have cast their vote. It is also optional, and if it exists, the contents will be displayed after the results for the booth that it is associated with are displayed. 2.6 Other files associated with Voter Plus. -------------------------------------------- VOTER.WEL - This contents of this file are displayed each time a caller enters Voter Plus. There is just one file for both COLOR and Non-COLOR callers. PCBoard style color codes are used in this file. See APPENDIX A for a chart of these codes. VOTER.KEY - When you register Voter Plus you will receive a "key" file that will be personalized with your BBS name. The presense of this file will also disable the display of the "UNREGISTERED" messages and will adding new booths up to the maximum of 100. 3.0 Upon Entering The Door --------------------------- Upon entering Voter Plus, the caller will see the version of the door and a line that contains the BBS name (or "UNREGISTERED"). They will then see Voter Plus's initial welcome screen, followed by the optional display file 'VOTERWEL'. If the caller is in alternate-language mode, Voter Plus will look for and display the file 'VOTERWEL.xxx', where xxx equals the .LNG extension as defined in PCBSetup. Following this they will see the Main Menu. The Voter Plus Main Menu Commands are explained below: 9 ------------------------------------------------------------------------- Page 9 Voter Plus Page 9 ------------------------------------------------------------------------- 3.1a Voting On A Booth ----------------------- <V> Vote on a Booth - This is how the caller votes. After selecting <V> the caller will be shown a list of the available booths and then the following command prompt: Vote On Which Booth, <#>, <A>ll, <N>ew, <Enter>=Quits ? <#> - Entering a booth number will allow the caller to vote on the corresponding booth. Voter Plus will check the .USR file to determine whether or not the caller has already voted on this booth. If he has, and he is permitted to change his vote, then he will start the change vote procedure. If he is not allowed to change his vote, he will be informed of this and will be sent back to the Main Menu. If he has not yet voted on the booth, he will be shown a list of the available answers. If the creator of the booth answered YES to "Allow voter to add there own answer", they will also see this option. If they chose an existing answer, the total vote count for the booth will be increased by one, as well as the count for the answer they chose. The user's name will also be added to the .USR file to prevent them from voting on this booth again. They may however change their vote provided this option is defined as YES in the booth's .VTR file. If they chose to add their own answer, the answer will be saved to the .VTR file, the number of answers for the booth will be increased by one, total votes will be increased by one, the count for the new answer will be set to one, and the caller's name will be added to the .USR file as above. <A>ll - Selecting the <A>ll option will allow the caller to vote on all of the existing booths in one shot. Voter Plus will check to see whether they have already voted on each booth. If they have, they will be informed of this, and then next booth will be checked. If a booth is found that the caller has not voted on, they will be given the opportunity to do so. Following casting their vote, or aborting the vote, Voter Plus will continue checking until all booths have been checked. 10 ------------------------------------------------------------------------- Page 10 Voter Plus Page 10 ------------------------------------------------------------------------- Note: If the caller has already voted on a booth, they will NOT be given an opportunity to change their vote. This will be true regardless of whether the booth is con- figured to allow changing votes or not. The MUST choose an individual booth in order to change their vote. <N>ew - Selecting the <N>ew option will allow the caller to vote on all of the existing booths that were CREATED after a given date. The date defaults to the caller's last logon date, but may be changed to a date of the caller's chosing. With the above exception, this function operates in an identical manner to the <A>ll function. <Enter> - Hitting the ENTER key returns the caller to the Main Menu. 3.1b Leaving A Comment Only --------------------------- <L> Leave A Comment - This allows the caller to leave a comment on a booth subject without voting. They will be permitted to leave a comment whether they have voted on the booth or note. 3.2 Viewing The Booth Results ------------------------------ <R> Booth Results - This is how the caller views the results of the voting. After selecting <R> the caller will be shown a list of the available booths and then the following command prompt: See results from which booth, <#>, <A>ll, <N>ew, <Enter>=Quits ? <#> - Entering a booth number will allow the caller to view the results from the the corresponding booth. After entering a valid booth number, they will be asked whether they wish to see the results in (G)raph or (C)hart format. A few notes here about ANSI... The Graph display makes use of ANSI cursor control codes. This requires that the the caller be using a terminal emulation that supports ANSI. If you are running a PCBoard 14.5(a) system, then you should have answered YES to this question in the VOTER.CNF file. Voter Plus will read the PCBOARD.SYS file and if they are NOT ANSI compatible, then they will not be asked which format they would like -- Voter Plus 11 will automatically show them the Chart format. ------------------------------------------------------------------------- Page 11 Voter Plus Page 11 ------------------------------------------------------------------------- The remainder of the <R> function requires little explan- ation. The <A>ll and <N>ew subcommands work much the same way as they do in the <V>ote function, with the exception that when using the <N>ew subcommand, only booths that have been VOTED ON after the date will be shown. 3.3 Creating New Booths ------------------------ <C> Create a New Booth - This function is used to add additional booths to Voter Plus. After selecting <C> and answering Y to whether they really wish to create a new booth, the caller will be prompted for a FileName for the booth. This can be any valid DOS filename up to eight letters or digits may be used. This name will be assigned to the booth's control files. Next, the caller will be prompted for the SUBJECT of the booth. The subject may be up to 60 characters in length. The next prompt will be for the actual QUESTION that is to be voted on. They will be allowed 60 characters for the question. The caller will then be asked whether or not they will their name to be displayed as the creator of the booth. If they answer No, the name ANONYMOUS will be displayed when another caller is voting on or viewing the results for this booth. The SysOp will always be shown the creator's real name when using the <S>ysOp function. The next prompt will be whether the voter should be permitted to add THEIR OWN answer to the poll. The next prompt will be whether the voter should be permitted to CHANGE their vote. Next, the caller will have an opportunity to write a 15 line detailed description of the booth subject. This will be saved to a file called xxxxxxxx.TXT (Where xxxxxxx is the 8 character DOS name). This file will be displayed prior to voting on the booth, and prior to viewing the booth results. The final phase of the Create process is the entering of the answers that the person voting will choose from. The maximum number of answers is 25. The maximum length of each answer is 40 characters. When they are finished, the VOTER.CNF & VOTER.DAT files will be updated, the .VTR file will be created with the information for the booth, and an empty .USR file will be created. 12 ------------------------------------------------------------------------- Page 12 Voter Plus Page 12 ------------------------------------------------------------------------- 3.4a Turning Color On & Off ---------------------------- <A> ANSI Color On/Off - This function simply toggles whether ANSI color is used within the Voter Plus Door. 3.4b Expert Mode Toggle ------------------------ <X> Expert Mode Toggle - This allows the caller to toggle whether they are in Expert Mode. When in expert mode, the Main Menu will NOT be displayed. 3.5 Redisplaying The Initital Screen ------------------------------------- <I> Info on Voter Plus - This function simply displays Voter Plus opening screen. 3.6 Returning To The BBS ------------------------- <Q> Quit Voter Plus - This function simply returns the caller to the BBS. 3.7a Editing A Booth ---------------------- <E> Edit a Booth - This function allow an existing booth to be edited. If Voter Plus is unregistered, the ONLY person that is permitted to use this feature will be the SysOp. If the door is registered, AND the SysOp has allowed this feature to be used (see VOTER.CNF), the creator of the booth will be permitted to edit the QUESTION and the ANSWERS. If the booth has been voted on, care should be taken not to change the context of the question or the answers. 3.7a Deleting A Booth ---------------------- <D> Delete a Booth - This function allow an existing booth to be deleted. If Voter Plus is unregistered, the ONLY person that is permitted to use this 13 ------------------------------------------------------------------------- Page 13 Voter Plus Page 13 ------------------------------------------------------------------------- feature will be the SysOp. If the door is registered, AND the SysOp has allowed this feature to be used (see VOTER.CNF), the creator of the booth will be permitted to DELETE the entire booth, icluding all of it's control files. If you don't like the idea of callers being able to delete a booth, simply answer NO to this option in VOTER.CNF 3.8 SysOp Report ----------------- <S> SysOp Report - This function allows the SysOp to view the pertinent information for each booth. Also displayed is a list of the callers that have voted on the booth as well as which answer they chose. 3.9 Getting Help In Voter Plus ------------------------------- <H> Help With Voter Plus - This should be self-explanatory. 4.0 Technical notes -------------------- Voter Plus has been designed to run primarily on PCBoard systems. It should however, operate on any BBS type that can produce PCBOARD.SYS, PCBOARD.DAT and USERS files, either directly, or through the use of a door monitor or conversion program. At this time it has been successfully tested on PCB14.5a, SpitFire 3.2, and Prologon/ProDoor systems. Carrier is monitored by Voter Plus at all times. Should a caller drop carrier while in Voter Plus they will be returned to the BBS, which will detect the "no carrier" status and re-cycle appropriately. Voter Plus works with non-standard com ports ,addresses, and IRQs. COM1 is address 3F8/IRQ 4. COM2 is address 2F8/IRQ 3. If a COM port other than 1 or 2 is used, the following SET statements must be used. SET COMBASE=nnnn Sets the base I/O address (in DECIMAL) for non-standard COM ports. Use this in conjunction with the COMIRQ environment variable. SET COMIRQ=n Sets the IRQ level for non-standard COM ports. Use this in conjunction with the COMBASE environment variable. 14 ------------------------------------------------------------------------- Page 14 Voter Plus Page 14 ------------------------------------------------------------------------- 4.1 Running Voter Plus In Stand-Alone Mode ------------------------------------------- To run Voter Plus in stand-alone local mode, type the following from the DOS command line or via a batch file: voter voter.cnf c:\pcb LOCAL A valid PCBOARD.DAT file must reside in the directory pointed to by the second parameter, (c:\pcb above). Also, LOCAL must be in uppercase. 4.2 Where to receive assistance -------------------------------- If you experience difficulty either installing or operating Voter Plus, you may reach me in the following ways: Paradox BBS - (302) 645-7264 USR D/S (302) 645-2658 USR HST Salt Air BBS - DOORS Conference. RIME - COMMON, DOORS, or SYSOPS Conference. Please route all messages to Node ->PARADOX ILink - SYSOPS Conference. 4.3 Error messages ------------------- Once properly installed, Voter Plus should not display any error messages. In the unlikely event that an error should occur, it will be recorded in the CALLERx log file, and/or in a file called $DOOR.ERR located in the Voter Plus home directory. When seeking assistance, please be sure to include any error codes or messages. 4.4 Caller log entries ----------------------- Voter Plus makes pertinent entries into the caller log as follows: * VOTER PLUS - Deleted: BOOTHNAME - Caller Deleted The Listed Booth * VOTER PLUS - Created New Booth: BOOTHNAME - Caller Created The Listed Booth * VOTER PLUS - Added a New Answer to Booth: BOOTHNAME - Caller Added His Own Answer To Listed Booth * VOTER PLUS - Voted On Booth: BOOTHNAME - Caller Voted On The Listed Booth * VOTER PLUS - Deleted: BOOTHNAME - Caller Deleted The Listed Booth 15 ------------------------------------------------------------------------- Page 15 Voter Plus Page 15 ------------------------------------------------------------------------- * VOTER PLUS - Left a Comment On Booth: BOOTHNAME - Caller Entered A Comment Following Voting On The Listed Booth * VOTER PLUS - Changed Vote In Booth: BOOTHNAME - Caller Changed His Vote In The Listed Booth * VOTER PLUS - *ERROR - Unable To Open: FILENAME - Voter Plus Was Unable To Open The Listed File 4.5 Problems With Non-PCBoard Systems -------------------------------------- The following guidelines are provided to help facilitate running the Voter Plus Door on SpitFire 3.2 BBS Systems. Spitfire creates 2 data files, "SFDoors.Dat, and "Door.Sys". Neither is directly compatable with Voter Door. You will need to convert SFDoors.Dat to "PCBoard.Sys", "PCBoard.Dat", and "Users" files, with your favorite door dat file converter. QKDoor, or the WildFire Door Monitor will successfully do the job for you. Both have been tested and proven to work nicely. There is a few things that still need to be done to complete the job. Below is a sample batch file to run the Voter Door. You will note that there is a directory called (PCB14). There is a reason for this which I will explain. The PCBoard.Dat file is used to supply the comm. port to the Voter door, some other directories used if you are running a PCBoard BBS. This is where the problem comes in, your not running PCBoard software, so the directories written in this file do not exist. So you need to edit this file to state valid directorys for each line, then just simply use it to overwrite the PCBoard.Dat file created each time the door is run, or copy the other two files (PCBoard.Sys, Users.) into the same directory that your newly edited PCBoard.Dat is located. Whichever way you decide to go is fine, just as long as all three files are within the same directory, and that you use the edited PCBoard.Dat file, and not the one created by a door converter. You will direct Voter to the directory of the data files on the command line in your batch file used to load the door. Example below. ****************************************************************** @ECHO OFF QKDOOR C:\SF\DOOR C:\SF {Converts Door.Sys to PCBoard format} COPY PCBOARD.SYS C:\PCB14 COPY USERS. C:\PCB14 CD\SF\DOORS\VOTER VOTER VOTER.CNF C:\PCB14 {Loads door, pointing to proper} {location of door control files.} ****************************************************************** Whichever door converter you decide to use, you must remember to always use the edited PCBoard.Dat file you edited. 16 ------------------------------------------------------------------------- Page 16 Voter Plus Page 16 ------------------------------------------------------------------------- 4.6 PCBoard Color Codes ------------------------ The Following Is a Table For The PCBoard "@X" Color Codes. Background (First Digit) Foreground (Second Digit) ------------------------ ------------------------- Black = 0 Black = 0 Blue = 1 Blue = 1 Green = 2 Green = 2 Cyan = 3 Cyan = 3 Red = 4 Red = 4 Magenta = 5 Magenta = 5 Yellow = 6 Yellow = 6 White = 7 Blue = 7 Background w/ Blinking Foreground High Intensity ---------------------- ------------------------- Black = 8 Black = 8 Blue = 9 Blue = 9 Green = A Green = A Cyan = B Cyan = B Red = C Red = C Magenta = D Magenta = D Yellow = E Yellow = E White = F Blue = F Examples: Bright White on Blue Background = @X1F Bright Yellow on Green Background = @X2E Dark Blue Blinking on White Background = @XF1 4.7 Disclaimer and warranty ---------------------------- Voter Plus is a shareware product. Voter Plus may be uploaded to BBS systems as long as no files are added or removed to/from the original archive and the program and it's associated documentation is in no way modified. There are no warranties, expressed or implied, for unregistered copies of Voter Plus. Sysops who install Voter Plus on their systems assume any and all liabilities for anything which may result as a consequence of running Voter Plus. Under no circumstances shall I, KEITH N. COCHRAN be liable for any loss of profit or any other damages, including but not limited to special, incidental, consequential, or other damages, arising out of the use or inability to use Voter Plus. PCBoard, DESQView, SpitFire and WildFire are registered trademarks of their respective owners. ProDoor, ProLogon and ProKit are shareware products written by Samuel Smith. QKDoor is a shareware product written by Chris Hall. 17 ------------------------------------------------------------------------- Page 17 Voter Plus Page 17 ------------------------------------------------------------------------- 4.8 Kudos ---------- Thanks to Sam Smith for the ProKit libraries that made writing Voter Plus a lot easier. Thanks to the following ßeta testers for their help in testing Voter Plus, and for their many ideas and suggestions: Butch Dunn - The No*Name BBS - Wilmington, DE Mike Hudson - Taurus BBS - Millsboro, DE Greg Parsons - Paradise Cove BBS - Selbyville. DE Thanks to Mike Hudson for writing the documentation dealing with running Voter Plus under SpitFire. And a special thank you to my wife, Dee, who has put up with my endless hours sitting in front of the keyboard over the last couple of months. I dedicate Voter Plus to her. 5.0 Registering Voter Plus --------------------------- Registration removes the [UNREGISTERED] message upon opening and closing the door, allows creating up to 99 booths, and allows the caller to use the Edit & Delete features. Registration also enables you to use the NEWBOOTH program with Voter Plus. Registration is $25.00 and may be paid by check or money order Refer to the ORDER.FRM file for complete registration instructions.